home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / win / c / winbgn.com / README.TXT < prev    next >
Encoding:
Text File  |  1990-09-30  |  5.9 KB  |  143 lines
  1.                 WinBegin
  2.  
  3.     WinBegin 3.0 is a development tool for creating very simple "C" 
  4. programs which run under Windows 3.0.  WinBegin is meant to be used by
  5. the "C" programmer who wants to create his or her first Windows program.
  6. The more experienced Window developer may find it useful for making
  7. skeleton programs for new applications.  I still use it to start new
  8. programs
  9.  
  10.     WinBegin actually generates "C" and Windows code for a small
  11. application.  When the user chooses the "Make Program" menu option,
  12. WinBegin prompts for a program name, a directory name, a program 
  13. description, and the author's name.  When all these items have been
  14. entered, WinBegin creates the source code for a Windows application.
  15. The files created include:
  16.  
  17. name.c
  18. name.h
  19. name.def
  20. name.rc
  21. name.ico
  22. name
  23.  
  24. where "name" is the program name selected by the author. The "name.c"
  25. file contains the application's "C" source code.  "name.h" contains
  26. constant definitions.  "name.def" contains information needed by Windows
  27. at link time.  "name" contains a makefile for compiling the application.
  28. "name.ico" contains a dummy (blank) icon for the application.  You can,
  29. and should, make a meaningful icon for your application using the icon
  30. editor in "sdkpaint.exe". 
  31.  
  32.     After running WinBegin, you should change to the directory 
  33. that you chose to contain the generated code.  Then type "make name"
  34. to create a Windows executable file.  If you have enough memory, you
  35. can do this withing Windows.  Otherwise, you need to exit to DOS first.
  36.  
  37.     What does this executable file do?  It contains two menu items:
  38. File, and GetText.  File has two choices:  Exit, and About this application.  
  39. The About choice displays an About dialog box with the name of the program
  40. and the author's name.  GetText displays a dialog box which prompts for
  41. a line of text.  When the box is exited, the text is displayed on the
  42. screen.  The executable file also can display an About box which contains
  43. a description of the program and a copyright notice with the author's
  44. name.  
  45.     Thus WinBegin creates source code for an application that has
  46. menu-bar commands, and which uses two dialog boxes.  This is what I 
  47. consider to be the smallest non-trivial Windows program.  The generated
  48. files are meant to be modified!  Here are some things to try:
  49.  
  50. -  Add another menu item.  Adding, deleting, and changing the names of
  51.    menu items are just about the easiest things to do in Windows.
  52.  
  53. -  Add another dialog box.  Remember that the names of the dialog box
  54.    functions must be added to the EXPORTS section of the name.def file,
  55.    in order to prevent nasty things from happening.
  56.  
  57. -  Experiment with some of the more sophisticated dialog box controls,
  58.    such as list boxes and edit boxes.
  59.  
  60. -  Instead of printing text using TextOut, try out some of the drawing
  61.    functions, such as Rectangle and LineTo.
  62.  
  63. Files included in the archive are:
  64.  
  65. readme.txt
  66. winbegin.exe
  67. winbegin.dat
  68. winbegin.ico
  69. target.ico
  70.  
  71.  
  72.  
  73. Copyright 1987,1990 by Susan Crayne.  All Rights Reserved
  74. Written for uploading to Compuserve Forums by
  75.  
  76.     Susan Crayne
  77.     4 Charlotte Place
  78.     Hartsdale, New York 10530
  79.     
  80.     914-686-9822
  81.  
  82. WinBegin 3.0 is shareware.
  83.  
  84. If this program has been useful to you, please register!  You will 
  85. receive bug fixes and enhancements when they occur.  Your input about
  86. future enhancements will be highly valued.  To register, send $35 to 
  87. the above address.
  88.  
  89. This program may be distributed freely.  If it is distributed, this file
  90. (readme.txt) must be included.  The copyright holder offers no
  91. warranty with this code whatsoever, including its fitness for any particular
  92. purpose.  Neither shall she be liable for damages of any kind that may arise
  93. from its use.
  94.  
  95.          ----------------end-of-author's-documentation---------------
  96.  
  97.                          Software Library Information:
  98.  
  99.                     This disk copy provided as a service of
  100.  
  101.                            Public (software) Library
  102.  
  103.          We are not the authors of this program, nor are we associated
  104.          with the author in any way other than as a distributor of the
  105.          program in accordance with the author's terms of distribution.
  106.  
  107.          Please direct shareware payments and specific questions about
  108.          this program to the author of the program, whose name appears
  109.          elsewhere in  this documentation. If you have trouble getting
  110.          in touch with the author,  we will do whatever we can to help
  111.          you with your questions. All programs have been tested and do
  112.          run.  To report problems,  please use the form that is in the
  113.          file PROBLEM.DOC on many of our disks or in other written for-
  114.          mat with screen printouts, if possible.  PsL cannot debug pro-
  115.          programs over the telephone, though we can answer questions.
  116.  
  117.          Disks in the PsL are updated  monthly,  so if you did not get
  118.          this disk directly from the PsL, you should be aware that the
  119.          files in this set may no longer be the current versions. Also,
  120.          if you got this disk from another vendor and are having prob-
  121.          lems,  be aware that  some files may have become corrupted or
  122.          lost by that vendor. Get a current, working disk from PsL.
  123.  
  124.          For a copy of the latest monthly software library newsletter
  125.          and a list of the 2,000+ disks in the library, call or write
  126.  
  127.                            Public (software) Library
  128.                                P.O.Box 35705 - F
  129.                             Houston, TX 77235-5705
  130.  
  131.                                  Orders only:
  132.                                 1-800-2424-PSL
  133.                               MC/Visa/AmEx/Discover
  134.  
  135.                           Outside of U.S. or in Texas
  136.                           or for general information,
  137.                               Call 1-713-524-6394
  138.  
  139.                           PsL also has an outstanding
  140.                           catalog for the Macintosh.
  141.  
  142.  
  143.